home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
remote
/
eracem.zip
/
ERACEM.DOC
next >
Wrap
Text File
|
1992-01-25
|
7KB
|
194 lines
┌────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┐
│ │
│ THIS IS A BETA VERSION! This BETA version of eRACEm has been │
│ released to the general public under the following conditions: │
W W
A 1: You accept FULL responsibility for any and all damage A
R this software may cause to your system because of bugs R
N or any other unforseen problems. N
I I
N 2: You should not expect bug fixes or updates with any N
G regularity nor should you expect elaborate docs or G
│ packaging. │
│ │
│ │
│ │
└────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┘
DO NOT use this software if any of the above bothers you. eRACEm has been
running in the daily maintenance batch file of a number of systems for a
few weeks now. So far, all has gone well but you should still excercise
caution.
eRACEm; A RemoteAccess Pack (Erase 'em) and sort utility.
Disclaimer:
If you use this, you accept any damage or loss that may occur with your
user related files. If you cannot accept this condition then DO NOT use
this program.
I made every effort to insure eRACEm is safe to use. It has worked
perfectly for me but things can go wrong and bugs can surface under
conditions which I did not and cannot forsee.
eRACEm makes NO attempt to share the user files with any other task. If
you attempt to pack or sort the user file while RA is active, you are
asking for trouble and eRACEm will most likely give it to you.
Purpose:
eRACEm is a replacement for the RAUSER packing utility supplied with
RemoteAccess. While RAUSER is a fine utility, it does not provide the
number of options many SysOps want.
eRACEm will pack your user file using all the familiar RAUSER options and
adds a few more. Additionally, eRACEm can sort the user file in the same
run and do so on multiple fields in user selectable ascending or descending
order.
eRACEm was written to replace the built in Pack/Sort options of a future
version of RACE and as such, requires a valid RACE.CFG file for various
bits of info.
usage:
You may mix and match any of the pack switches with the sort options or you
may pack only or sort only.
PACKING -
Pack Switches:
-P pack the user file, removing deleted users. This switch is only
necessary if you do not use either the -D or -G switch.
-Ms Do not purge users that are ABOVE (s) security level. This is
slightly different than RAUSER for which this switch means do
not purge users AT this level or above.
-M10 will allow purging of security level 10 and below in eRACEm
but RAUSER will do only those users below 10 with this switch.
Think of it as the -M(aximum) level to purge.
-Dn purge users that have not called in n days.
-Gg Purge users in Group g.
-K DO NOT honor the no-kill flag. If the user has the no-kill flag
set, it will not protect him/her if any of the other parameters
are met.
-O Write deleted users to USERS.OLD. This is a USERS.BBS type of file
that is used by RACE in the WHOOPS! option. WHOOPS! can restore
purged users. Useful if you mistakenly use -D6 instead of -D60 and
wipe out 90% of your users.
See the RACE documentation for more information on USERS.OLD and the
RACE Whoops! function.
-L Log the results of a pack to RACEPACK.LOG. This log file will contain
the user's name, security level, group and last time called in date and
number of days format. All this info is written for each user no matter
which command line switches were used. The name of this log is hard
coded into eRACEm.
SORTING -
The sorting of the user file works quite a bit differently than both the
internal RACE sort and the sort provided by RA's RAUSER program.
eRACEm will make use of EMS (if available) or the hard drive for temporary
files if the user file is so large it cannot be sorted entirely in memory.
This should solve the problem some have had with RACE while trying to sort
user files that contained in excess of 2000 users.
Like the RACE internal sort, eRACEm will allow you to sort on a number of
selectable fields. The difference is that eRACEm will allowing sorting on
more than one field at a time. A few additional fields have been added to
eRACEm.
Here are the allowable sort fields:
Name Security Group UpK DownK Ups Downs Posts Calls Credit Pending
The names of the sort field options are pretty descriptive so I won't bore
you with a description of what each one is.
In addition, you MUST specify a ascending or descending sort of a field by
appending a + or - to the sort field name.
eRACEm will allow you to specify as many sort keys as there are field
options to sort on but keep in mind that it makes little sense to use more
than two or maybe three sort keys.
Here's a quick example and the results of this one would be fairly familiar
to all RAUSER sorters out there.
eRACEm -S[Security- Name+]
This sort command line would first sort the users by security level in
a highest level to lowest level and within those security levels, sorted by
name, A to Z. This is the method "RAUSER -S" provides.
Note that the delimiters =ARE REQUIRED= to delimit the sort options
IF you want to use more than one option. DO NOT use delimiters if you
only sort on one field.
Allowable delimiting characters are [], "" and '', i.e. square brackets,
double quotes and single quotes.
A sort on name only would appear like so...
eRACEm -Sname+
The + and - appended to the sort key name is NOT optional. One or the
other (plus or minus) must be used.
The sort is performed in the order in which the keys are used. The
first key is the primary key and so on.
Another example:
eRACEm -S"Name+ Security-"
Using the NAME as the primary key is a valid method. If you use the NAME
as a primary key, having a secondary key is almost useless.
Why? It is very unlikely that a system will have more than one or two
users with the EXACT same last name. Since the above command line will
first sort on last name, the security level will only come into play if two
or more users have the exact same last name.
Yet another example:
eRACEm -S'Security- Group+ Name+'
Here is what this would produce:
Security Group Last Name
--------------------------
100 0 ADAMS
100 0 BAKER
100 1 ANDREWS
100 1 CHARLES
90 0 ANDERSON
90 1 AARON
90 2 ALLAH
90 2 BELDON
And that's all he wrote for now. Hope it works ok for you :-)
mike